Table of Contents To jump to a topic, select its title & choose "Next Case" (⌘N) To find a term in Glossary, select it & choose "Glossary" (⌘G) ViewIt™ 2.04 On-Line Help Copyrights Distribution Trademarks Warranties 1. Getting Started What Is ViewIt? About On-Line Help Read Startup Topics Recompiling Demos Shareware Limits 2. What is FaceWare? 3. What is a module? 4. Where do they live? 5. How do I meet one? 6. Minimum Code • Pascal • C • Fortran 7. Include Files FaceStorXY File FaceProcXY File Other Include Files 8. Resource Files Shared vs. Program-Specific Temporary Res Files More About LoadIt The FaceWare File Resource Numbering 9. Initializations FaceWare Initialization More About Stack Space Record Initialization 10. Event Handling 11. Summary New Programs Existing Programs V1. ViewIt 2.0 Guide No License Fees Do Your Own Thing Simpler Resources On-Line Editing Built-In Help Backward Compatible Powerful Controls View Hierarchy Data Linking Source Available V2. Editing Windows/Views/Controls Editing Resources Selecting Controls The Controls Bar The Icon Menu Bar • File Menu • Edit Menu • Import Menu • Info Menu • Style Menu • Align Menu • Grid Icon Outline Mode Saving Changes Getting Into Trouble V3. Windows Modal vs. Modeless Adding Windows Modal Windows • Item Events • Editable Items • Menu Events • Module Messages • Other Modal Events • Event Summary • Loop Options Modeless Windows • Modeless Events • Modeless-to-Modal Closing Windows Miscellaneous Notes V4. Views About Control Drivers The View Driver • Operation • Scrolling • Instructions • Common Uses • Limitations • Source Code V5. Controls Getting Info Toolbox Calls Rectangles Scrolling Growing Floating Styles Colors Best Colors V6. Data Links Data Types Choosing Controls Linking A Record Linking A Variable Using Links Special Cases V7. Balloons (System 7) Help Command Format Example Commands V8. Override (Advanced) Direct Installation vs. Proc ID Table Procedure Format Procedure Execution • Posting Commands • Stealing Messages • Tweaking Messages • Major Action Before • Major Action After Control Message Documentation Program-Controlled Regions Limitations & Warnings V9. ViewIt Commands NewWnd,EndWnd,MdlWnd,SizWnd,MovWnd,ShoWnd, HidWnd,SavWnd,HlpWnd,GetWnd,GetCtl,GetWVC, ShoCtl,ActCtl,SelCtl,SavCtl,DspCtl,GetVal, SetVal,AddVew,AddCtl,LnkCtl,OvrCtl,DrwCtl, ScrCtl,StlCtl V10. fRec Record V11. Resources Shared FaceWare File Customizing Resources Moving Modules Removing Resources V12. Odds & Ends INIT Problems Clobbered Variables Program Drawing The Help Key Spurious Events V13. 2.0 -> 2.04 F1. FaceIt 2.0 Guide Brief History Mixing Window Types FaceIt Command Format Program Resources F2. Initializations Menu Initialization • Auto-Loaded Menus • Hierarchical Menus • Pop-Up Menus Window Initialization Palette Initialization F3. The Main Loop Message Types Module Messages Apple Events Foreign Windows F4. Menu Handling Menu Item Types • Unlabeled Program Items • Labeled Program Items • Program-Wide Standard Items • Shared Standard Items • Module-Specific Standard Items Font/Size/Style/Color Items Managing Menu Items Custom Standard Items Balloon Help F5. Palette Menus Custom MDEF & WDEF Palette Events Creating Palettes Installing Palettes Managing Palettes Saving Settings Palette Titles Patterns & Colors Torn-Off Behavior Errors & Memory F6. Background Processing (Advanced) What To Do When To Do It FaceIt's Role An Example Other Events WaitNextEvent? F7. Finder Resources Adding File Icons Opening From Finder • Optional Help • Technical Details Size and Behavior Program File Help F8. Hybrid Programs What Is FaceSt? When To Use FaceSt When NOT To Use It What You GAIN What You LOSE Initializations Done Installing FaceStub Using FaceStub • Main Menus • Menu Events • Raw Event Loop • Switching • Window Kind • Cursor Management • Program Termination • Custom Procedures • FSSC Menus F9. FaceIt Commands DoInit,DoAuto2,DoLoop,DoEvnt,DoMenu,DoUpdt2, GetMsg,GetFWs U1. UtilIt 2.0 Guide UtilIt Command Format UtilIt Resources U2. Menus Labeled Items FSSC Menus PopMen,SetItm2,GetItm,FixFSC,SelFSC U3. Files StdOpn,StdSav,GetRef,SetRef,SetTyp U4. Windows SetFSS,SndBhd,GetNam,SetNam, MovRec,MovAlt,MovDlg,MovWin, DrgWnd,GetStd,SetStd,SavDlg,SavWin U5. Colors GetFgC,GetBkC,SetFgC,SetBkC,SetPal2 U6. Alerts ShoAlt,StpAlt,NotAlt,CtnAlt, ShoStr,StpStr,NotStr,CtnStr U7. Strings SetSub,TrmStr,SetPrm,CnvStr,FndTxt, NumToS,SToNum U8. String Lists GetStr,SetStr,SrtLst,DupLst, GetI2,GetI4,GetR4,GetR8,GetR10,GetR12 U9. Memory ChkMem,NewBlk,PrgCmd,DoUnld U10. Other Commands ChgCur,PstEvt,PstNot,SetIdl,EndIdl